home *** CD-ROM | disk | FTP | other *** search
- PPP Internet Connection Kit for MiNT
-
- Abel PHILIPPE
- October, 8th, 1996
-
- Version 1.4
-
- Description
- ----------------
-
- Here is a (near) ready-to-use kit to connect yourself to Internet with
- the PPP (Point to Point Protocol), and so access the WWW. It works under
- MiNT. Hey, stay here ! It is not necessary to have a Minix partition at
- all... This kit needs FreeMint 1.12.5, Mint OS 1.4.1, MintNet 1.0 pl1,
- the Cab_for_MintNet 1.77 overlay, HS Modem 07, pppd 2.2.0, and of course
- Cab 1.41.
-
- The use of Mint is totally transparent : no Unix command to learn ! After
- more than one month of unrewarded tries, and lots of spent nights (yeah,
- I know, I'm not very fast !), I finally made it, I succeed to connect to
- my provider. I must say that informations was very straggling, and I
- didn't know (nearly) anything to Mint, nor Internet (specially PPP
- connections).
-
- At this time, I succeded connections to two french providers (Compuserve
- and Imaginet). I don't know if it will work with others. In case of
- matters, don't hesitate to contact me.
-
- This connection strategy work fair well, very well, in fact.
- Nevertheless, it couldn't be considered (in my opinion) as a definitive
- solution. It is heavy to setup (now it is !), it needs place in RAM and
- HardDisk. As a Bulldozer for a sand castle (all of this to obtain a PPP
- connection...). I look forward a new STiK version. In the over way, the
- use of Mint open the way of all Unix applications for a minus coding
- effort.
-
- I installed this kit on a TOS 4.02 Falcon030 with 4MB of RAM. I can't
- help you for the other kinds of Atari.
-
- Configuration
- -------------
- I imagine that 2 Mo are necessary for this kit. If you succeed, tell it
- to me !
-
- You will need 350 Ko on the boot disk, 1.3 Mo for the MINTNET folder (see
- below), 900 Ko for Cab, and a few Mo if possible for the Cab cache.
-
- As usual, the use of boot driver (as Xboot 3.0 & cie) is highly
- recommended !
-
- Essential Stuff
- ---------------
-
- In add of this kit, you'll need these softwares :
- HS Modem 07 Cab 1.41
-
- You can find these files at the ftp of the CNAM, in France, for example.
-
- At the end, you'd better find and install these tools :
- C_ed 0.3 (Cab cache driver)
- ApexViewers 4.1 (fast GIF, JPEG, TGA and FLI viewers)
-
- Internet Access Providers
- -------------------------
- You have to choose a provider who offer a PPP connection with dynamic IP
- number allocation (this number identifies your computer in the Net). I
- think all providers offer that.
-
- Once you've suscribed, ask your providers small CAPITAL infos :
-
- - his modem phone number
-
- - the connection parameters : speed, parity (even or none), number of bit
- (7 or 8), control protocol (RTS/CTS, Xon/Xoff or none).
-
- - his DNS number (Domain Name Server). It's a computer which be asked by
- the Atari to convert HTTP (http://www.eff.net) or FTP (ftp.cnam.fr)
- adresses in IP number.
-
- - his domain. For exemple, the Compuserve Domain is compuserve.com
-
- - your login (don't smile...)
-
- - your password (who said "security" ?)
-
- - his newsgroups server (or UseNet server)
-
- - his e-mail server
-
- - his netmask. This number tells which parts of the IP address can change
- from a connection to another. a 255 means it can change, as a 0 means it
- can't (the compuserve netmask is 255.255.255.0).
-
- Installation
- --------------
-
- 1. Before begining, you may keep in a safe place a copy of all stuff
- you'll install, in case of crashes.
-
- 2. Put HS Modem in your AUTO folder, so you'll have a correct serial
- port. Care that DRVIN.PRG must be loaded before the appropriate driver !
- Set up your driver with SETTER.TTP. Here are the parameters I gave to the
- SCC driver with my Falcon :
-
- M2TT : U
- M1EMU : U
- LANBIT : N
- LANEXT : N
- LAN_S2 : U
- DTRM2 : Y
- DTRS2 : N
- M2DRI : N
- S2DRI : N
- RBLM2 : 2048
- TBLM2 : 256
- RBLS2 : 256
- TBLS2 : 256
-
- Note : I have put 2048 bytes for the reception buffer of the modem2 port.
- Like that, my modem can still receive data during about 1 second, even
- during disk access : this improve a little bit the transfert. So adapte
- this buffer size to your configuration.
-
- 3. Check that you don't have a MINT.CNF file at the root of your boot
- partition, nor MINT or MULTITOS folder. If yes, move or rename them.
-
- 4. Unpack the file BOOT.TOS at the root of your boot partition, and then
- launch it. It's an auto-extractible archive. Check that MINTNP.PRG will
- be the last launched program of the AUTO folder. The MINT folder contains
- the configuration file MINT.CNF, the PPP drivers of the net-101b.tgz kit
- (ie SLIP.XIF and SOCKDEV.XDD)
- (Note : XIF = eXtended InterFace, XDD = eXtended Device Driver).
- It also contains OLDTOS.PRG which will launch the TOS of your Atari after
- loaded MiNT. You'll find also at the same root the NOHOG.ACC accessory.
- It also came from net-101b.tgz. It is essential to use a one-task-at-time
- TOS, to forbid MiNT conflicts with MintNet.
-
- 5. Choose a 1.5 Mb free partition. It could be your boot drive.
- Here is the point : we will create a folder that will be considerated by
- MiNT as a Minix partition. Uncompress the MINTNET folder of the archive.
- Here is his architecture :
-
- MINTNET --|-- BIN <- for binaries
- |
- |-- ETC <- informations to change
- |
- |-- HOME
- |
- |-- TMP <- the temporaries files of applications
- | will be here
- |
- |
- |-- USR -- UCB <- empty for now
- |
- |-- VAR --|-- ADM <- error messages
- |
- |-- LOG <- same thing
-
-
- I want to notice here a bad thing. In order to be executed from the
- desktop, a program must have a TTP ( or PRG, GTP...). So I renamed SH
- (it's a shell) in SH.TTP. But after this, other programs as pppd don't
- find it. So I decided to put two copies of this shell, SH and SH.TTP. A
- better idea is welcome...
-
- 6. Choose a partition, with a big amount of free space on it !
- CAB will put here all informations from Internet (HTML pages, images,
- sounds, movies...). If you not reserve enough space, Cab will delete old
- files to put the newer ones. Create a WWWCACHE folder in the chosen
- drive.
-
- 7. Install Cab. Choose the correct RSC file in CAB\RSC folder (default is
- english), and rename it CAB.RSC in the same folder than CAB.PRG. You can
- destroy the RSC folder after that. It will free space ! Open Cab. In
- Option menu, choose Path and full it with the WWWCACHE directory you've
- just created. Copy the CAB.OVL file of the kit into the CAB\MODULES
- folder.
-
- 8. With a text editor (vi, everest...), modify the \MINT\MINT.CNF file.
- Search the following lines :
- sln d:\mintnet\bin u:\bin
- sln d:\mintnet\etc u:\etc
- sln d:\mintnet\usr u:\usr
- sln d:\mintnet\var u:\var
- sln d:\mintnet\tmp u:\tmp
-
- replace all "d:" by the letter of the drive where you put MINTNET. Now,
- you can access (when MiNT is active, for sure...) your "Mint partition"
- by the unified drive "U:". Instead of searching a program in
- d:\mintnet\bin, you may search in u:\bin.
-
- 9. Modify the \MINTNET\ETC\CHATFILE file.
- For this, you have to write a connection script which depends of your
- provider. I'll take the example of Compuserve, as they are my provider...
- I used Storm (but you can use connect 2.46 or any communication soft
- instead).The following is the way a connection occurs (-> indicates what
- I typed, # is a comment) :
-
- *********************************************************
- ->ATM(return) # to shut down the modem sound
- OK
- ->ATD36064444(return) # National french TRANSPAC number
- CONNECT 57600
- TRANSPAC 240901019
- ->196282595(return) # TRANSPAC number of Compuserve
- COM
- Host Name:
- ->CIS(return) # Compuserve Information Service
- User ID:
- ->MY_COMPUSERVE_NUMBER/GO:PPPCONNECT\MY_PASSWORD(return)
- PPP Connection
- One moment please...
- ******************************************************************
- Following a PPP request, constitued by esoteric signs. Your
- \MINTNET\ETC\CHATFILE will exactly describe what the \BIN\CHAT program
- will send to the modem, and what response is expected from your provider.
- For this goal, I picked out some keywords that have to be expected by
- CHAT for each action I do. Be careful, you'd better choose short
- keywords, to be sure they'll be recognized. As example, I choose PAC
- instead of TRANSPAC, one more reason is that firts letters are often
- skipped.
-
- Action I do Keywords I wait
- ATM OK
- ATD36064444 CONNECT
- PAC
- 196282595 ame:
- CIS ID:
- MY_COMPUSERVE_NUMBER/GO:PPPCONNECT\MY_PASSWORD
-
- Now You just have to copy these datas in the \MINTNET\ETC\CHATFILE file.
- Let's begin by define the messages which indicate that the connection
- failed (compulse your modem manual...)
-
- ******************************************************
- ABORT 'NO DIALTONE'
- ABORT 'NO CARRIER'
- ABORT BUSY
- ABORT WAIT
- ABORT DELAYED
- ******************************************************
-
- Now I can type the commands :
- ******************************************************
- ""
- atm OK
- atdt36064444 CONNECT
- "" PAC
- 196282595 Name:
- CIS ID:
- MY_COMPUSERVE_NUMBER/GO:PPPCONNECT\\MY_PASSWORD
- ******************************************************
-
- Notes :
- a) the "" indicate no response or no request.
- b) CHAT accepts CR, but want a space character between each command.
- So do'nt forget it - I put it at the end of each line -.
- c) \\ are not mistaken.
-
- 10. Modify your \MINTNET\ETC\CONNECT.SCR
- As I use a falcon, I use the /dev/modem2 port. It can be different on
- another computer. When MiNT is running, have a look at the u:\dev\
- folder. All ports are listed.
-
- 11. Modify the \MINTNET\ETC\RESOLV.CON
- Replace compuserve.com with your provider's domain name.
- Replace Compuserve's nameserver (149.174.211.5) with your provider's one.
- You may put several ones.
-
- 12. Reboot. Open a window on U:\BIN\. Install the application SH.TTP and
- give it 'SCR' as document type. Change the path of this window to
- U:\CAB\. Open a new window on U:\ETC\SCR\.
-
- 13. Load the utilitary MODEM.CPX. Paramit it in following informations of
- your Internet Acces Provider (IAP). You must know that HS MODEM convert
- 110 bps to 38400 and 134 to 57600. Save informations of the CPX. Save the
- desk.
-
- How To Use
- ----------------
- Launch the CONNECT.SCR connection script by double-clicking on it. This
- script will launch pppd which launch chat. Some informations will be
- displayed to tell you how the connection evoluate (later, you'll change
- the /etc/syslog.conf to correct this). After a while, your modem's leds
- will stop lighting : you are connected !
-
- Now you can launch CAB... Have a nice netsurfing !
-
- Warning : Wait you are well-connected before run CAB. If not, the overlay
- won't be active, and so you couldn't access Internet.
-
- On a lot of Web page, it is possible to send mail to the author. Don't
- try for this time : Cab_for_MiNTNet 1.77 don't allow this option :-(
-
- To end the connection, launch the DCNNCT.SCR. This will interrupt the PPP
- connection, and hang up the modem. I recommand always that you finish by
- this way. Like that your IAP will know that you are not still connected !
-
- Before to turn off your Atari, launch EXIT.SCR. It is more clean.
-
- I personnaly use 2 configurations :
- - one for the connection to Internet, with HS Modem and MiNT. I launch it
- in monochrome for a maximum of speed and memory.
- - one for consulting pages downloaded, without MiNT nor HS Modem, but
- with SpeedoGDOS, in 256 colors.
-
- With NVDI, displays are so quick that you can connect you directly in 256
- colors without an important loss of time.
-
- If it works
- -----------
- You can modify the kit to remove message at the connection. Edit the file
- \ETC\CONNECT. Remove -d parameter in the call to pppd and -v to the two
- calls to chat.
-
- If it doesn't work
- ------------------
- Begin with disconnect, reboot, and relaunch connection : sometime it
- doesn't work at the first time !
-
- If the connection seems to be well happend and that, nevertheless, Cab
- can't load page that you ask, try to see a little thing : when you ask it
- a new address HTTP, Cab must interroge your IAP for decoding this
- address. You should then see the send LED, and after the receive LED of
- your modem flash. If not, then Cab don't even know that you are
- connected.
-
- You'll find in the U:\BIN\ folder some utilitaries which allow you to see
- the MiNTNet configuration. Begin by launch the shell TCSH.TTP without
- parameters. The screen is cleared, with a prompt /home->
- You can then launch programs by tipping thier name and RETURN. Try to
- launch route, ifconfig and netstat. Here is what I get when I'm connected
- :
-
- /etc-> route
- Destination Gateway Flags Ref Use Metric Iface
- default 206.175.66.56 UGD 1 21 0 ppp0
- 206.175.66.56 * UHD 1 0 0 ppp0
- 127.0.0.0 * U 1 0 0 lo0
- 127.0.0.1 * UH 1 0 0 lo0
- 199.174.233.26 * UH 1 11 0 lo0
-
- Note :
- 199.174.233.26 is the number my IAP give to my computer.
- 206.175.66.56 is the number of my IAP computer.
- The first line indicate that if I want to connect me to another computer,
- I must pass throught my provider.
-
- /etc-> ifconfig
- lo0: flags=0x4b<UP,BROADCAST,LOOPBACK,RUNNING>
- inet 127.0.0.1 netmask 255.0.0.0 broadcast 127.255.255.255
- metric 0 mtu 16384
- in-packets 0 in-errors 0 collisions 0
- out-packets 0 out-errors 0
- ppp0: flags=0x51<UP,POINTOPOINT,RUNNING>
- link-level-flags=0x3b
- inet 199.174.233.26 netmask 255.255.255.0 dstaddr 206.175.66.56
- metric 0 mtu 1500
- in-packets 16 in-errors 3 collisions 0
- out-packets 22 out-errors 0
-
- /etc-> netstat
- Active TCP connections
- Proto Recv-Q Send-Q Local-Address Foreign-Address State
- Active UDP connections
- Proto Recv-Q Send-Q Local-Address Foreign-Address State
- UDP 0 0 *:* *:* CLOSED
-
- For leaving TCSH, type 'exit'.
-
- You can also ask to SYSLOGD to store messages which are send by PPPD and
- CHAT in the file \VAR\ADM\MESSAGES. Begin in editing the file
- \ETC\SYSLOG.CON. Add a line '-d ' (with a space !), and the keyword '-v'
- in the two calls to CHAT. Try a new connection. And read the file
- \VAR\ADM\MESSAGES : it contains the description of your connection, step
- by step, with PPP negociation and so on. Check the size of this file : it
- grownth quick. When it is too big, reboot without MiNT (like that this
- file will not be protected), and replace it by an empty file.
-
- Contribution
- ------------
- As I said, I spent lot of time in understanding how that works. I should
- consacrate this time in preparing my maths master. So you may send me a
- ridiculous $10 fee to support me ! If I'm overflowed by questions, I'll
- response in priority to the "registered" guys (which I think it's normal,
- don't you ?).
-
- At the end, don't forget to register CAB too. Alexander Clauss has to be
- congratulated for his marvellous soft.
-
- Useful address
- --------------
- If you want to know more about MiNT (I read this page at the end of my
- work... arghh...) :
- http://www.gti.net/azog/mint-docs.html
-
- Cab author :
- Alexander Clauss
- Stresemannstr. 44
- D-64297 Darmstadt
- Germany
- Email : aclauss@rbg.informatik.th-darmstadt.de
-
- MiNTNet author :
- Kay Roemer
- Email : roemer@vsb.informatik.uni-frankfurt.de
-
- HS modem author :
- Harun Scheutzow
- Dresdener Stra₧e 83
- D-10179 Berlin, Germany
- Mausnet: Harun Scheutzow @B
- Email : Harun_Scheutzow@b.maus.de
- (Email < 16 kbyte only)
-
- Cab_for_MiNTNet author :
- Andrew Vesperman
- Email : dancer@brisnet.org.au
-
- Me :
- Abel PHILIPPE
- 16, rue St Ferdinand
- 75017 PARIS
- Email : p-abel@imaginet.fr
-
- As usual, if you you have any comments to tell or any correction to give,
- please contact me. I'll take them in consideration in further versions
-
- Oh ! I was forgetting : thanks to Sebastien Ducleroir for the
- translation.